Installation and Activation of EMS Microsoft 365 Web Add-In

Learn how to install and activate EMS for Outlook – Microsoft 365.

Prerequisites

For EMS M365 Web Add-In 226.2, you need to uninstall the old version and reinstall the latest version of the manifest file.

Install EMS for Outlook – Microsoft 365

  1. From the downloads portal, download Ems.Web.Addin.msi.

  2. Run the .msi file on your application server.

  3. Enter the full path for the installation location and click Next.

  4. Enter your environment's Platform Services URL and the virtual directory name you want. Click Next.

  5. Click Install. You might be asked to provide admin consent.

On-prem Customers

Option 1:

On-premises customers should follow the same process as cloud customers to connect to EMS's Entra App instance.

  1. Download the Manifest: Use the following URLs:

    1. Sandbox Manifest: https://emsoutlookweb-zue-ua.emscloudservice.com/manifest

    2. Production Manifest: https://emsoutlookweb-zue-pr.emscloudservice.com/manifest

  2. Whitelist the following IP addresses in your firewall based on your hosted region to connect to EMS Platform Services:

AU UA: 23.101.216.12
CA UA: 20.63.32.36
EU UA: 40.113.130.16
UK UA: 51.140.140.24
US UA: 168.62.39.152
AU PR: 23.101.216.13
CA PR: 20.63.32.37
EU PR: 40.113.130.17
UK PR: 51.140.140.25
US PR: 168.62.39.153

Option 2:

Create an Entra App.

  1. Create an App Registration at your tenant in Microsoft Entra ID.

  2. In the Authentication Menu, add the Single-page Application platform.

  3. Add the following Redirect URIs:

    1. The URI of your app (for example, https://myaddress.com)

    2. A special URI to grant Outlook access: (for example, brk-multihub://myaddress.com)

  4. Provide the MSI installer with the Application ID from the overview page.

  5. Install Ems.Web.Addin.msi with the addition of the App Id in the Platform Service URL during installation.

  6. Download the Manifest. Use the following URL:

    1. On-prem customers: https://<YourCompany>.com/EmsWebAddin/manifest.xml

    2. The manifest file is hosted at the installation directory of the web add-in: app_url/manifest.xml

Activate/Enable EMS M365 web add-in

We recommend enabling the EMS for Outlook – Microsoft 365 add-in for a small set of users first to test the add-in before enabling it for the entire team.

If you upload the manifest file manually, make sure you use the latest Outlook add-in manifest file. Older versions can prevent the add-in from working as expected.

For End Users

  1. Download the Manifest File:

    1. On-prem customers: https://<YourCompany>.com/EmsWebAddin/manifest.xml

    2. Cloud customers:

      1. Sandbox Manifest: https://emsoutlookweb-zue-ua.emscloudservice.com/manifest

      2. Production Manifest: https://emsoutlookweb-zue-pr.emscloudservice.com/manifest

  2. Install the Add-in:

    1. Click https://aka.ms/olksideload to open Outlook add-in management.

    2. Click My add-ins.

    3. Click Add a custom add-in.

    4. Select Add from File....

    5. Upload the downloaded manifest file.

    6. Click Install. If Outlook shows a warning about adding a custom add-in, select Install to continue.

For a more detailed walk-through, follow the instructions for adding a custom add-in.

For Exchange Administrators (Enabling for Entire Organization)

  1. Go to Microsoft 365 Admin Center (https://admin.cloud.microsoft/), the select Settings > Integrated apps. Or directly to Integrated apps via this link: https://admin.cloud.microsoft/#/Settings/IntegratedApps

  2. In Deployed apps menu, select Upload custom apps.

  3. In Upload custom app fill the information:

    1. For App type select Office Add-in

    2. Select Provide link to manifest file.

    3. Insert the manifest URL for either Production (https://emsoutlookweb-zue-pr.emscloudservice.com/manifest ) or Sandbox (https://emsoutlookweb-zue-ua.emscloudservice.com/manifest)

    4. Click Validate.

      The Manifest file is validated and appears below the URL field.

  4. Select Next, specify the users you wish to be granted access to the add-in:

    • Just me

    • Entire organization

    • Specific users/groups

  5. On the next screen, review and accept the app permissions. Then selectNext.

  6. Review the selected settings:

    • Apps to deploy: Outlook

    • Assigned users

    If the information is correct, select Finish deployment.

    Deployment of the manifest file can take up to 72 hours. During this time, you can’t use the M365 Web Add-in until the manifest is uploaded or updated.

    To change user assignments, manage the add-in within Integrated apps.

Customers utilizing the EMS Entra App

Action Required:

  • Work with Professional Services or Support to provide allowable domains for EMS for Outlook web add-in connection.